home *** CD-ROM | disk | FTP | other *** search
/ AGA Toolkit '97 / The AGA Toolkit '97.iso / c / view80.doc < prev    next >
Text File  |  1996-09-07  |  9KB  |  252 lines
  1. ********************************************************************************
  2.  
  3. ##           ##                             #####    #####         #############
  4.  ##         ##                             ##   ##  ##   ##           ##   ##
  5.   ##       ##  ##  #######  ##         ##  ##   ##  ##   ##           ##   ##
  6.    ##     ##   ##  ##       ##   ###   ##   #####   ##   ##           ##   ##
  7.     ##   ##    ##  ######    ## ## ## ##   ##   ##  ##   ##           ##   ##
  8.      ## ##     ##  ##        ## ## ## ##   ##   ##  ##   ##           ##   ##
  9.       ###      ##  #######    ###   ###     #####    #####         #############
  10.  
  11.  
  12.  
  13.                                 Version 2.00
  14.  
  15.  
  16.  
  17.                              Copyright © 1991 by
  18.  
  19.                               Federico Giannici
  20.                               Viale Francia 4
  21.                               90146 Palermo
  22.                               Italy
  23.  
  24.                              All rights reserved.
  25.  
  26.  
  27. My MC-Link (+39 6 4180440) code is MC4080.
  28.  
  29. ********************************************************************************
  30.  
  31.  
  32.  
  33.  
  34. View80 II is a fast and powerful ASCII Text-Reader.
  35.  
  36.  
  37. This program is ShareWare.
  38. It can be freely copied, provided that no change is made to the program or to 
  39. the documentation and that the archive is left intact. The program can't be 
  40. included in any commercial program without my written permission.
  41. If you use View80 II, you have the moral duty to send me a contribution. The 
  42. suggested amount is $15 or Lire 20.000. In this way I can continue to improve 
  43. this already great program.
  44. It's up to you!
  45.  
  46.  
  47. View80 II works fine also with the Kickstart 2.0. Better still, it takes 
  48. advantage of some features of this new version of the operating system.
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  LOADING
  55. ~~~~~~~~~
  56. You can load the program both from Workbench or CLI.
  57.  
  58.  
  59. From Workbench
  60. --------------
  61. You can doubleclick the View80 icon or insert the View80 name and path in the 
  62. "Default Tool" of the icon of the textfile that you wish to read with View80.
  63. You can also use multiple selection (with the SHIFT key) to choose one or more 
  64. files to load automatically.
  65.  
  66.  
  67. From CLI
  68. --------
  69. You can get the usual help specifying a "?" as first argument (the rest of the 
  70. arguments are ignored). Typing "?" again, you will be given more help (a la 
  71. ARP).
  72. Anyway the syntax is:
  73.  
  74. View80 [filenames or wildcards] [NODETACH] [ICONIFY].
  75.  
  76. Normally View80 detaches itself from the starting CLI. To avoid this you can 
  77. specify the NODETACH keyword.
  78. With the ICONIFY keyword you can freeze immediately View80 in the iconify 
  79. status. It's useful to run View80 and set it in "stand by" with your startup-
  80. sequence.
  81. To specify a file named 'nodetach' or 'iconify' you can enclose its name between
  82. quotes (").
  83.  
  84.  
  85.  
  86.  
  87.  THE LIBRARIES
  88. ~~~~~~~~~~~~~~~
  89. View80 II makes use of three libraries not present in the standard Workbench 
  90. disk. It works also without any library, but to get the best of it you have to 
  91. copy the following libraries (included in this archive) in your "LIBS:" 
  92. directory.
  93. - req.library: for the file-requester and the color-requester.
  94. - arp.library: for the pattern-matching in file loading.
  95. - powerpacker.library: to decrunch PowerPacker's crunched data files.
  96.  
  97. To load View80 II from any disk without having to Assign the "LIBS:" directory, 
  98. you may find useful an utility written by Nicola Salmoria, whose name is 
  99. "LibReq". It allows to load libraries, devices and fonts from any mounted 
  100. volume, and displayes a requester if such files cannot be opened. The current 
  101. (15 Feb 91) version of LibReq is 1.5.
  102.  
  103.  
  104.  
  105.  
  106.  THE CONFIGURATION FILE
  107. ~~~~~~~~~~~~~~~~~~~~~~~~
  108. When you load View80 II, it searches its configuration file: "View80.config".
  109. First, it searches in the "S:" directory, then, if it's failed, it tries in the 
  110. same directory from where it was loaded (i.e. if you typed "dir/View80" it will 
  111. search in the "dir" directory).
  112. This is to allow you to load View80, with your favorite configuration, from any 
  113. disk, without having to Assign the "S:" directory.
  114. NOTE: View80 isn't currently able to find its directory if it is executed thru 
  115. the DOS "path" command. So, leave the configuration file in S: or use the 
  116. complete path to load View80.
  117. The configuration includes the following information:
  118. - The screen colors.
  119. - The status of all the "Preferences" menu items.
  120. - The status of all the "Settings" of every buffer.
  121. - The last search string and the status of all the search parameters.
  122. - The current directory of the file-requester and the contents of the "Hide" and
  123. "Show" gadgets.
  124. - The status of the range-mode gadget.
  125. - The position of the iconify-window.
  126.  
  127.  
  128.  
  129.  
  130.  REPLYING TO THE REQUESTERS 
  131. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  132. You can reply to any requester both with the mouse or the keyboard.
  133. Pressing the ESC key you select the "CANCEL" gadget (if it's present) with any 
  134. other key you select the "OK" gadget (if it's present).
  135.  
  136.  
  137.  
  138.  
  139.  SCREEN DESCRIPTION
  140. ~~~~~~~~~~~~~~~~~~~~
  141. One peculiarity of View80 is the horizontal scrollbar. It allows you to 
  142. visualize 80 columns of text and use the scrollbar at the same time.
  143. At the left of the scrollbar there is the indicator of the current line number 
  144. (the 'current' line is the first on the screen). It works also as the jump-to 
  145. gadget (if the buffer isn't empty).
  146. In the top of the screen there are (from left to right) the close gadget, the 
  147. range-mode gadget, the index-of-buffers gadget, the ten buffer gadgets, and 
  148. information about name, size and number of lines of the current file.
  149.  
  150.  
  151.  
  152.  
  153.  SELECTING A BUFFER
  154. ~~~~~~~~~~~~~~~~~~~~
  155. View80 II can load up to 10 files in 10 different buffers.
  156. There are many ways to change the currently shown buffer, both with the keyboard
  157. and the mouse.
  158. With the keyboard, press the corresponding numeric key. Alternatively you can 
  159. also press the numeric keys on the keypad while holding down the SHIFT or ALT 
  160. keys.
  161. With the mouse, simply click on the buffer gadget.
  162. NOTE: Double-clicking a buffer gadget will load a new file in that buffer.
  163. You can also go up and down through the buffers with the F5-F6 keys or with the 
  164. "-" and "+" keys in the keypad.
  165. Finally you can use the "Index Of Buffers" command or gadget (see later).
  166.  
  167.  
  168.  
  169.  
  170.  SCROLLING
  171. ~~~~~~~~~~~
  172. View80 II can scroll through the text at five (actually they are six) different 
  173. speeds. The first three speeds are very smooth, both forwards and backwards. Try
  174. to find another program that gives you such a good scroll!
  175. You can scroll both with keyboard and mouse.
  176.  
  177.  
  178. Keyboard scrolling
  179. ------------------
  180. You can scroll up and down with the corresponding arrow keys.
  181. The spacebar activates the autoscroll: continue to scroll down without having to
  182. hold down the key.
  183. You can change the scroll speed at any time pressing one of the following keys:
  184.        CTRL --> Smooth-Scroll    (slower)
  185.       SHIFT --> Fast-Scroll
  186.         ALT --> Turbo-Scroll
  187. SHIFT & ALT --> Flash-Scroll     (faster)
  188.  
  189. By using the LEFT or RIGHT arrow keys you can move through the text, page by 
  190. page (the last line of the previous page will be shown in order not to loose the
  191. thread of what you was reading). If you press the SHIFT key the movement will be
  192. carried out in Fast-Scroll.
  193. By using the ALT key with the LEFT or RIGHT arrow keys you can jump to the top 
  194. or to the bottom of the text.
  195.  
  196. The numeric keypad normally works in a MS-DOS like manner.
  197.  
  198. The HELP key shows you a brief reminder of the functions of all the keys. So I 
  199. don't repeat that reminder here.
  200. Pressing the HELP key with the SHIFT or ALT key you call the "Information" 
  201. requester.
  202.  
  203.  
  204. Mouse scrolling
  205. ---------------
  206. With the mouse you can scroll using the scrollbar or clicking on the screen. The
  207. nearer to the top or bottom edge you click, the faster the text scrolls.
  208.  
  209.  
  210.  
  211.  
  212.  RANGE MODE
  213. ~~~~~~~~~~~~
  214. You can select a range for a subsequent "Save", "Print", "Copy to the Clipboard"
  215. or simply to mark a location.
  216.  
  217. To select a range you have to set View80 in the range-mode, selecting the first 
  218. item in the last menu or simply clicking on the "R" gadget in the top of the 
  219. screen.
  220. While in range-mode, the mouse is used to select the range in the usual way. For
  221. long selections you can use the "Select All", "Change Start of Range" and 
  222. "Change End of Range" menu-items in the rightmost menu.
  223. When View80 is in range-mode you can continue to scroll with the mouse simply 
  224. clicking at the very left or right of the screen.
  225.  
  226. You can also set the range with the F1 and F2 keys, respectively to select the 
  227. start and end of the range
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.                               -------------
  235.                                 THE MENUS
  236.                               -------------
  237.  
  238.  
  239. In the rest of this document, I'll suppose you are not a stupid and I'll leave 
  240. out some details that you can understand by your own. If I haven't anything 
  241. interesting to say about some menu item I'll simply write "No comment".
  242.  
  243.  
  244. ---------
  245.  Project
  246. ---------
  247.  
  248. Load...
  249. ~~~~~~~
  250. View80 II uses the well-known req.library file-requester. If the req.library 
  251. isn't available, View80 uses a very simple requester.
  252. You can select up to 10 files (holding down the SHIF